﻿/**
 * @license Copyright (c) 2003-2014, CKSource - Frederico Knabben. All rights reserved.
 * For licensing, see LICENSE.md or http://ckeditor.com/license
 */

/**
 * @fileOverview The "filebrowser" plugin that adds support for file uploads and
 *               browsing.
 *
 * When a file is uploaded or selected inside the file browser, its URL is
 * inserted automatically into a field defined in the <code>filebrowser</code>
 * attribute. In order to specify a field that should be updated, pass the tab ID and
 * the element ID, separated with a colon.<br /><br />
 *
 * <strong>Example 1: (Browse)</strong>
 *
 * <pre>
 * {
 * 	type : 'button',
 * 	id : 'browse',
 * 	filebrowser : 'tabId:elementId',
 * 	label : editor.lang.common.browseServer
 * }
 * </pre>
 *
 * If you set the <code>filebrowser</code> attribute for an element other than
 * the <code>fileButton</code>, the <code>Browse</code> action will be triggered.<br /><br />
 *
 * <strong>Example 2: (Quick Upload)</strong>
 *
 * <pre>
 * {
 * 	type : 'fileButton',
 * 	id : 'uploadButton',
 * 	filebrowser : 'tabId:elementId',
 * 	label : editor.lang.common.uploadSubmit,
 * 	'for' : [ 'upload', 'upload' ]
 * }
 * </pre>
 *
 * If you set the <code>filebrowser</code> attribute for a <code>fileButton</code>
 * element, the <code>QuickUpload</code> action will be executed.<br /><br />
 *
 * The filebrowser plugin also supports more advanced configuration performed through
 * a JavaScript object.
 *
 * The following settings are supported:
 *
 * <ul>
 * <li><code>action</code> &ndash; <code>Browse</code> or <code>QuickUpload</code>.</li>
 * <li><code>target</code> &ndash; the field to update in the <code><em>tabId:elementId</em></code> format.</li>
 * <li><code>params</code> &ndash; additional arguments to be passed to the server connector (optional).</li>
 * <li><code>onSelect</code> &ndash; a function to execute when the file is selected/uploaded (optional).</li>
 * <li><code>url</code> &ndash; the URL to be called (optional).</li>
 * </ul>
 *
 * <strong>Example 3: (Quick Upload)</strong>
 *
 * <pre>
 * {
 * 	type : 'fileButton',
 * 	label : editor.lang.common.uploadSubmit,
 * 	id : 'buttonId',
 * 	filebrowser :
 * 	{
 * 		action : 'QuickUpload', // required
 * 		target : 'tab1:elementId', // required
 * 		params : // optional
 * 		{
 * 			type : 'Files',
 * 			currentFolder : '/folder/'
 * 		},
 * 		onSelect : function( fileUrl, errorMessage ) // optional
 * 		{
 * 			// Do not call the built-in selectFuntion.
 * 			// return false;
 * 		}
 * 	},
 * 	'for' : [ 'tab1', 'myFile' ]
 * }
 * </pre>
 *
 * Suppose you have a file element with an ID of <code>myFile</code>, a text
 * field with an ID of <code>elementId</code> and a <code>fileButton</code>.
 * If the <code>filebowser.url</code> attribute is not specified explicitly,
 * the form action will be set to <code>filebrowser[<em>DialogWindowName</em>]UploadUrl</code>
 * or, if not specified, to <code>filebrowserUploadUrl</code>. Additional parameters
 * from the <code>params</code> object will be added to the query string. It is
 * possible to create your own <code>uploadHandler</code> and cancel the built-in
 * <code>updateTargetElement</code> command.<br /><br />
 *
 * <strong>Example 4: (Browse)</strong>
 *
 * <pre>
 * {
 * 	type : 'button',
 * 	id : 'buttonId',
 * 	label : editor.lang.common.browseServer,
 * 	filebrowser :
 * 	{
 * 		action : 'Browse',
 * 		url : '/ckfinder/ckfinder.html&amp;type=Images',
 * 		target : 'tab1:elementId'
 * 	}
 * }
 * </pre>
 *
 * In this example, when the button is pressed, the file browser will be opened in a
 * popup window. If you do not specify the <code>filebrowser.url</code> attribute,
 * <code>filebrowser[<em>DialogName</em>]BrowseUrl</code> or
 * <code>filebrowserBrowseUrl</code> will be used. After selecting a file in the file
 * browser, an element with an ID of <code>elementId</code> will be updated. Just
 * like in the third example, a custom <code>onSelect</code> function may be defined.
 */

(function () {
    // Adds (additional) arguments to given url.
    //
    // @param {String}
    //            url The url.
    // @param {Object}
    //            params Additional parameters.
    function addQueryString(url, params) {
        var queryString = [];

        if (!params)
            return url;
        else {
            for (var i in params)
                queryString.push(i + "=" + encodeURIComponent(params[i]));
        }

        return url + ((url.indexOf("?") != -1) ? "&" : "?") + queryString.join("&");
    }

    // Make a string's first character uppercase.
    //
    // @param {String}
    //            str String.
    function ucFirst(str) {
        str += '';
        var f = str.charAt(0).toUpperCase();
        return f + str.substr(1);
    }

    // The onlick function assigned to the 'Browse Server' button. Opens the
    // file browser and updates target field when file is selected.
    //
    // @param {CKEDITOR.event}
    //            evt The event object.
    function browseServer(evt) {
        var dialog = this.getDialog();
        var editor = dialog.getParentEditor();

        editor._.filebrowserSe = this;

        var width = editor.config['filebrowser' + ucFirst(dialog.getName()) + 'WindowWidth'] || editor.config.filebrowserWindowWidth || '80%';
        var height = editor.config['filebrowser' + ucFirst(dialog.getName()) + 'WindowHeight'] || editor.config.filebrowserWindowHeight || '70%';

        var params = this.filebrowser.params || {};
        params.CKEditor = editor.name;
        params.CKEditorFuncNum = editor._.filebrowserFn;
        if (!params.langCode)
            params.langCode = editor.langCode;

        var url = addQueryString(this.filebrowser.url, params);
        // TODO: V4: Remove backward compatibility (#8163).
        editor.popup(url, width, height, editor.config.filebrowserWindowFeatures || editor.config.fileBrowserWindowFeatures);
    }

    // The onlick function assigned to the 'Upload' button. Makes the final
    // decision whether form is really submitted and updates target field when
    // file is uploaded.
    //
    // @param {CKEDITOR.event}
    //            evt The event object.
    function uploadFile(evt) {
        var dialog = this.getDialog();
        var editor = dialog.getParentEditor();

        editor._.filebrowserSe = this;

        // If user didn't select the file, stop the upload.
        if (!dialog.getContentElement(this['for'][0], this['for'][1]).getInputElement().$.value)
            return false;

        if (!dialog.getContentElement(this['for'][0], this['for'][1]).getAction())
            return false;

        return true;
    }

    // Setups the file element.
    //
    // @param {CKEDITOR.ui.dialog.file}
    //            fileInput The file element used during file upload.
    // @param {Object}
    //            filebrowser Object containing filebrowser settings assigned to
    //            the fileButton associated with this file element.
    function setupFileElement(editor, fileInput, filebrowser) {
        var params = filebrowser.params || {};
        params.CKEditor = editor.name;
        params.CKEditorFuncNum = editor._.filebrowserFn;
        if (!params.langCode)
            params.langCode = editor.langCode;

        fileInput.action = addQueryString(filebrowser.url, params);
        fileInput.filebrowser = filebrowser;
    }

    // Traverse through the content definition and attach filebrowser to
    // elements with 'filebrowser' attribute.
    //
    // @param String
    //            dialogName Dialog name.
    // @param {CKEDITOR.dialog.definitionObject}
    //            definition Dialog definition.
    // @param {Array}
    //            elements Array of {@link CKEDITOR.dialog.definition.content}
    //            objects.
    function attachFileBrowser(editor, dialogName, definition, elements) {
        if (!elements || !elements.length)
            return;

        var element, fileInput;

        for (var i = elements.length; i--;) {
            element = elements[i];

            if (element.type == 'hbox' || element.type == 'vbox' || element.type == 'fieldset')
                attachFileBrowser(editor, dialogName, definition, element.children);

            if (!element.filebrowser)
                continue;

            if (typeof element.filebrowser == 'string') {
                var fb = {
                    action: (element.type == 'fileButton') ? 'QuickUpload' : 'Browse',
                    target: element.filebrowser
                };
                element.filebrowser = fb;
            }

            if (element.filebrowser.action == 'Browse') {
                var url = element.filebrowser.url;
                if (url === undefined) {
                    url = editor.config['filebrowser' + ucFirst(dialogName) + 'BrowseUrl'];
                    if (url === undefined)
                        url = editor.config.filebrowserBrowseUrl;
                }

                if (url) {
                    element.onClick = browseServer;
                    element.filebrowser.url = url;
                    element.hidden = false;
                }
            } else if (element.filebrowser.action == 'QuickUpload' && element['for']) {
                url = element.filebrowser.url;
                if (url === undefined) {
                    url = editor.config['filebrowser' + ucFirst(dialogName) + 'UploadUrl'];
                    if (url === undefined)
                        url = editor.config.filebrowserUploadUrl;
                }

                if (url) {
                    var onClick = element.onClick;
                    element.onClick = function (evt) {
                        // "element" here means the definition object, so we need to find the correct
                        // button to scope the event call
                        var sender = evt.sender;
                        if (onClick && onClick.call(sender, evt) === false)
                            return false;

                        return uploadFile.call(sender, evt);
                    };

                    element.filebrowser.url = url;
                    element.hidden = false;
                    setupFileElement(editor, definition.getContents(element['for'][0]).get(element['for'][1]), element.filebrowser);
                }
            }
        }
    }

    // Updates the target element with the url of uploaded/selected file.
    //
    // @param {String}
    //            url The url of a file.
    function updateTargetElement(url, sourceElement) {
        var dialog = sourceElement.getDialog();
        var targetElement = sourceElement.filebrowser.target || null;

        // If there is a reference to targetElement, update it.
        if (targetElement) {
            var target = targetElement.split(':');
            var element = dialog.getContentElement(target[0], target[1]);
            if (element) {
                element.setValue(url);
                dialog.selectPage(target[0]);
            }
        }
    }

    // Returns true if filebrowser is configured in one of the elements.
    //
    // @param {CKEDITOR.dialog.definitionObject}
    //            definition Dialog definition.
    // @param String
    //            tabId The tab id where element(s) can be found.
    // @param String
    //            elementId The element id (or ids, separated with a semicolon) to check.
    function isConfigured(definition, tabId, elementId) {
        if (elementId.indexOf(";") !== -1) {
            var ids = elementId.split(";");
            for (var i = 0; i < ids.length; i++) {
                if (isConfigured(definition, tabId, ids[i]))
                    return true;
            }
            return false;
        }

        var elementFileBrowser = definition.getContents(tabId).get(elementId).filebrowser;
        return (elementFileBrowser && elementFileBrowser.url);
    }

    function setUrl(fileUrl, data) {
        var dialog = this._.filebrowserSe.getDialog(),
            targetInput = this._.filebrowserSe['for'],
            onSelect = this._.filebrowserSe.filebrowser.onSelect;

        if (targetInput)
            dialog.getContentElement(targetInput[0], targetInput[1]).reset();

        if (typeof data == 'function' && data.call(this._.filebrowserSe) === false)
            return;

        if (onSelect && onSelect.call(this._.filebrowserSe, fileUrl, data) === false)
            return;

        // The "data" argument may be used to pass the error message to the editor.
        if (typeof data == 'string' && data)
            alert(data);

        if (fileUrl)
            updateTargetElement(fileUrl, this._.filebrowserSe);
    }

    CKEDITOR.plugins.add('filebrowser', {
        requires: 'popup',
        init: function (editor, pluginPath) {
            editor._.filebrowserFn = CKEDITOR.tools.addFunction(setUrl, editor);
            editor.on('destroy', function () {
                CKEDITOR.tools.removeFunction(this._.filebrowserFn);
            });
        }
    });

    CKEDITOR.on('dialogDefinition', function (evt) {
        // We require filebrowser plugin to be loaded.
        if (!evt.editor.plugins.filebrowser)
            return;

        var definition = evt.data.definition,
            element;
        // Associate filebrowser to elements with 'filebrowser' attribute.
        for (var i = 0; i < definition.contents.length; ++i) {
            if ((element = definition.contents[i])) {
                attachFileBrowser(evt.editor, evt.data.name, definition, element.elements);
                if (element.hidden && element.filebrowser)
                    element.hidden = !isConfigured(definition, element['id'], element.filebrowser);

            }
        }
    });

})();

/**
 * The location of an external file browser that should be launched when the **Browse Server**
 * button is pressed. If configured, the **Browse Server** button will appear in the
 * **Link**, **Image**, and **Flash** dialog windows.
 *
 * See the [File Browser/Uploader](http://docs.cksource.com/CKEditor_3.x/Developers_Guide/File_Browser_(Uploader\)) documentation.
 *
 *        config.filebrowserBrowseUrl = '/browser/browse.php';
 *
 * @since 3.0
 * @cfg {String} [filebrowserBrowseUrl='' (empty string = disabled)]
 * @member CKEDITOR.config
 */

/**
 * The location of the script that handles file uploads.
 * If set, the **Upload** tab will appear in the **Link**, **Image**,
 * and **Flash** dialog windows.
 *
 * See the [File Browser/Uploader](http://docs.cksource.com/CKEditor_3.x/Developers_Guide/File_Browser_(Uploader\)) documentation.
 *
 *        config.filebrowserUploadUrl = '/uploader/upload.php';
 *
 * @since 3.0
 * @cfg {String} [filebrowserUploadUrl='' (empty string = disabled)]
 * @member CKEDITOR.config
 */

/**
 * The location of an external file browser that should be launched when the **Browse Server**
 * button is pressed in the **Image** dialog window.
 *
 * If not set, CKEditor will use {@link CKEDITOR.config#filebrowserBrowseUrl}.
 *
 *        config.filebrowserImageBrowseUrl = '/browser/browse.php?type=Images';
 *
 * @since 3.0
 * @cfg {String} [filebrowserImageBrowseUrl='' (empty string = disabled)]
 * @member CKEDITOR.config
 */

/**
 * The location of an external file browser that should be launched when the **Browse Server**
 * button is pressed in the **Flash** dialog window.
 *
 * If not set, CKEditor will use {@link CKEDITOR.config#filebrowserBrowseUrl}.
 *
 *        config.filebrowserFlashBrowseUrl = '/browser/browse.php?type=Flash';
 *
 * @since 3.0
 * @cfg {String} [filebrowserFlashBrowseUrl='' (empty string = disabled)]
 * @member CKEDITOR.config
 */

/**
 * The location of the script that handles file uploads in the **Image** dialog window.
 *
 * If not set, CKEditor will use {@link CKEDITOR.config#filebrowserUploadUrl}.
 *
 *        config.filebrowserImageUploadUrl = '/uploader/upload.php?type=Images';
 *
 * @since 3.0
 * @cfg {String} [filebrowserImageUploadUrl='' (empty string = disabled)]
 * @member CKEDITOR.config
 */

/**
 * The location of the script that handles file uploads in the **Flash** dialog window.
 *
 * If not set, CKEditor will use {@link CKEDITOR.config#filebrowserUploadUrl}.
 *
 *        config.filebrowserFlashUploadUrl = '/uploader/upload.php?type=Flash';
 *
 * @since 3.0
 * @cfg {String} filebrowserFlashUploadUrl='' (empty string = disabled)]
 * @member CKEDITOR.config
 */

/**
 * The location of an external file browser that should be launched when the **Browse Server**
 * button is pressed in the **Link** tab of the **Image** dialog window.
 *
 * If not set, CKEditor will use {@link CKEDITOR.config#filebrowserBrowseUrl}.
 *
 *        config.filebrowserImageBrowseLinkUrl = '/browser/browse.php';
 *
 * @since 3.2
 * @cfg {String} [filebrowserImageBrowseLinkUrl='' (empty string = disabled)]
 * @member CKEDITOR.config
 */

/**
 * The features to use in the file browser popup window.
 *
 *        config.filebrowserWindowFeatures = 'resizable=yes,scrollbars=no';
 *
 * @since 3.4.1
 * @cfg {String} [filebrowserWindowFeatures='location=no,menubar=no,toolbar=no,dependent=yes,minimizable=no,modal=yes,alwaysRaised=yes,resizable=yes,scrollbars=yes']
 * @member CKEDITOR.config
 */

/**
 * The width of the file browser popup window. It can be a number denoting a value in
 * pixels or a percent string.
 *
 *        config.filebrowserWindowWidth = 750;
 *
 *        config.filebrowserWindowWidth = '50%';
 *
 * @cfg {Number/String} [filebrowserWindowWidth='80%']
 * @member CKEDITOR.config
 */

/**
 * The height of the file browser popup window. It can be a number denoting a value in
 * pixels or a percent string.
 *
 *        config.filebrowserWindowHeight = 580;
 *
 *        config.filebrowserWindowHeight = '50%';
 *
 * @cfg {Number/String} [filebrowserWindowHeight='70%']
 * @member CKEDITOR.config
 */
